Git Submodules（Git 子模块）

什么是 Git Submodules

Git Submodules 是 Git 中一种用于管理项目依赖关系的机制。它允许您将一个 Git 仓库嵌套在另一个 Git 仓库中，并将其视为一个独立的子项目

TIP

• 子模块允许您将外部仓库作为子目录包含在您的项目中，并保持这些子模块与其原始仓库的连接。这对于项目依赖管理非常有用，特别是项目依赖于其他开源库或共享代码时。

• 子模块的工作方式是，它会在主项目中包含一个指向子模块仓库的引用，并在主项目中维护一个特殊的文件（.gitmodules）来记录子模块的相关信息，例如子模块的远程仓库 URL、子模块的路径等。当克隆主项目时，默认情况下子模块中的内容不会被自动下载，而是需要手动初始化子模块。

---

使用子模块的主要情况包括：

• 当项目依赖于其他项目或库时，可以将其作为子模块引入。
• 当希望将子模块与主项目的开发过程分离，例如将子模块作为独立的仓库进行开发和维护。
• 当希望确保项目中使用的特定版本的依赖库保持一致性时。

如何添加 Git Submodules

要在 Git 仓库中添加子模块（submodule），可以按照以下步骤操作：

1. 打开终端或命令行界面，进入主 Git 仓库所在的目录。
2. 运行以下命令来添加子模块：

git submodule add <repository_url> <path_to_submodule>
# <repository_url> 是子模块的远程仓库地址。
# <path_to_submodule> 是子模块在主仓库中的路径。

例如：

git submodule add https://github.com/example/repo.git submodules/repo

3. Git 将下载子模块的内容，并将其保存在主仓库指定的路径下。
4. 运行以下命令来将子模块的更改添加到主仓库的暂存区：

git add <path_to_submodule>

5. 运行以下命令来提交更改：

git commit -m "Add submodule"

6. 更新主工程中的子模块

git submodule update